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71 1. Functional Section 

72 Cool ICE 1 . 1 is the second release of Cool ICE and is a feature rich release. 

73 1. 1 High Level Functional Description 

74 New features have been required in the following 3 main areas of Cool ICE: 
75 

76 > Organize & Manage 

77 • Maintaining Settings at System level 

78 • Improved GUI Interface 

79 • Service Templates 

80 • Importing Existing Runs 

81 • Expanded Repository Capability for storing Objects 

82 • Security Enhancements 

83 • Managing Static Documents 

84 • Arranging list of Categories and Services 

85 • Customizing Icons for Categories and Services 

86 • File Transfer between Workstation and Server 

87 • Drawer Browsing Capability 

88 • Service Expiration 

89 > Service Development 

90 • Additional System Variables 

91 • Enhanced Integration to HTML Authoring Tools 

92 • Image Maps Capability 

93 • Creating Services based on Templates 

94 • Cookies Support 

95 • Uploading Files 

96 • Downloading Files 

97 > Deployment 

98 • Enhance Session Management 

99 • Controlling System Availability & System Trace 

1 00 • Enhanced Graphics Support 

101 • Positional URL Parameters 

1 02 • Service Error Analyzer via the Browser 

1 03 • Additional System Variables 

1 04 • Support for Image Maps 

1 05 • Service Expiration Date Enforcement 

106 • Automatic Object Download 

107 • Image Viewer 

1 08 • User Password Change 

109 • Cookies Support 

110 • Repository Search Capability 

111 • Event Viewer 

112 • Uploading Files to the Repository 

113 • Enhanced Handling of HTML Tag Delimiters 

114 1.2 Requirements and Reference Documents 

115 The following table lists the requirements for Cool ICE 1 . 1 in the order they have been received. This list is 

116 a subset of the total requirements for Cool ICE and it only includes requirements specifically for the Cool 
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ICE Runware component. 
Cool ICE 1.1- Requirements 



Req. No 


Description 


1 


New Category attributes. When setting up a category it will be possible to specify the 
purpose/content of the category such as:- 

- Template category (When building services, this would allow to select a template that come 

rlosp tn what thp uspr want to Hn (\ p Hiffprent forms and different kinds of HataHasp arrpcc^ 

- Image category (This allow to store and reference Images in Cool ICE without the service 
developer has to develop special services top handle this) 

- Applet category (This allow to store and reference Applets in Cool ICE without the service 
develooers has to anvthinff^ 

- Normal Service category 

- Cool ICE System category (This allow the customers easily to take a copy of the Cool ICE 
system services and customize these services) 

Other category attributes such Read Only category and Access (Direct/Indirect) will be 
possible. 


2 


Allow the users to change their password. This include specifying user-id's for which change 
of password is not allowed (such as Guest user-id). 

A change of password needs to be communicated back to the Gateway so the gateway can 
update its session information. 


4 


Import HTML Template, optionally modify Hyper Link References and Form Action Field 
according to the ICE standard (<GURL>/Category/Service) 


12 


Import existing MAPPER Runs to the Repository. 


13 


Enhance the look and feel of dialog boxes to MS Sans Serif non-bold. 


14 


Export and Import of HTML to and from a service should be enhanced to allow for services 
that include more than one HTML template! 


15 


A function in ICE Administration to define structure of Categories and Services. In the 
current functionality a new Category and new Service is inserted at the bottom of the list. It 
will be required to specify some sort of structure in the list. 


18 


Add a new Attribute for Categories and Services for specifying icon to be displayed when 
building and displaying menu of categories and services. This is to provide an easy way of 
tailoring a look and feel for a user or group of users. 


19 


Enhance service development with features for maintaining a Library of reusable objects. This 
could be achieved through the use of template category as in Req. no 1. 


21 


Search facility to allow users to search for services in the repository. 


22 


Cool ICE Admin interface available from a browser. 
Initially only for selected administrative functions. 
View Event Log should be the first to implement. 


23 


Enhance Export service function and Source function enhanced to handle @brk @brk 

better. When in "Script on Mode", lines without @ must have an html tag delimiter ([) in order 
to change mode to "Script Off. 


25 


Function to take the whole Cool ICE system On and Off the net. 


26 


Improve handling of positional parameters on the URL. 


27 


When saving a service, verify that the original service report has not been change manually in 
the meantime by some one else. 


28 


Web-TX shared functionality: 

a) File upload to Cool-ICE 

b) File download to browser from Cool-ICE 

c) Session management 


32 


Possibility to turn Trace On/Off of the Cool ICE Service Handler. 


34 


Improve validation of existence of directories and files on the NT and UNIX system. 


40 


Single source for NT and UNIX 
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60 | Service Expiration Date enforcement 



120 
121 

122 

123 
124 

125 

126 
127 



129 
130 
131 
132 
133 
134 
135 
136 

137 
138 



139 

140 

141 
142 
143 
144 
145 
146 
147 

148 

149 
150 



1.2.1 Other Requirements that affect this implementation 

Migration from Cool ICE 1.0 must be seamless and must be handled automatic by the setup procedure. 

1.2.2 List of requirements which will not be met 

All requirements for Cool ICE 1 . 1 have been met. 



128 1.3 Dependencies 



Cool ICE 1.1 is dependent of the following 3 main features being delivered by WebTx 3.0 and the 
associated MAPPER Gateway: 

1) Uploading files via the browser from the client workstation to Cool ICE, 

2) Downloading flies/objects from the Cool ICE repository to the client workstation specifying 
appropriate MIME type. 

3) Secure Session Management. 



1.4 Definitions 



Term 


Definition 


Repository 


Storage for Cool ICE Services and objects. 


Service 


Item in the repository containing server side script that executes when 
requested from a client browser. 


Object 


Common term for all items stored in the repository. An object can 
contain binary information as well textual information such as 
GIF/JPG images, Applets, Word document, Cool ICE Services and 
Static HTML Documents. 















1.5 Description of Users 

There are three different types of users of Cool ICE: 



1) 
2) 
3) 



Developers who develop and maintain Cool ICE Web based services. 

People who will be administrating a Cool ICE Web Site. 

End users who will be accessing a Cool ICE Web Site using a browser. 



The same person will probably often perform the roles of category 1 and 2. 

1.6 Areas yet to be addressed. 

None. 
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151 

152 
153 



154 
155 
156 
157 
158 
159 



1 . 7 Functional Flow 

The following illustrate the main steps a developer would go through to develop a Cool ICE Web Service: 



Step 1 - Create HTML Template 

• Develop the HTML Template 

• Save it to disk 



Step 6 - Modify HTML Template 

• Switch to HTML Authoring tool 

• Open HTML Export file 

• Modify Template 

• Save it to disk 



Step 2 - Create New Service 

• Log on to MAPPER 

• Run ICEADMIN 

• Start a new service 

• Import HTML Template 

• Insert script functions 



Step 5 - Modify Service 

• Switch to ICEADMIN 

• Open the service 

• Modify script or 

• Export HTML template 





HTM. Document 
Hyper Link 

1355] 



Services 



^Step 4 - Test Service 

• Open the browser 

• Specify URL for Cool ICE 

• Follow the menu 



Step 3 - Save Service 

Save the Service in a Category 
in the Cool ICE Repository 
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160 
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162 
163 
164 
165 
166 

167 

168 
169 
170 
171 
172 

173 
174 



The following illustrate the 1 flow of events from when a browser at a client workstation requests a Cool ICE 
Web service and until a response is received in the browser: 



Browser receives the 
HTML Document 



HTML Document 
Hyper Link 



I Submit 



n 



Browser Requests a Service 

- Direct URL 

- Hyperlink 

- Form 



Input from Browser 

- Hyperlink Parameters 

- Form Input 



Web Server 
Cool ICE Gateway 



Cool ICE Service Handler 




Web Server 
Cool ICE Gateway 



Cool ICE Service Handler 



Cool ICE Service Handler 

- Service attributes from repository 

- Validate security 

- Create Service input 

- Call the service 



Cool ICE Service 



The Cool ICE Service 

- Input parameters are loaded 

- Script functions are executed 

- Output HTML Document 




Service Input 

- ICE System Variables 

- Browser Input 

- Style Guide Values 



1.8 User Interface Description 

Cool ICE has two different user interfaces: 

1 . Cool ICE Administration uses a traditional Microsoft Windows Graphical User Interface. 

2. Cool ICE Web Services uses a Browser HTML Interface. 

1.9 Resource estimate 

Project Manager is responsible for ensuring this section is completed before sign-off. 
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Task 


Estimated Effort 


Actual Effort 


1 . Write Functional Section 




Should be actuals now 


2. Review Functional Section 




Should be actuals 


3. Write Functional Description Section 






4. Review Functional Description Section 






5. W rite Design Details Section 






6. Review Design Details Section 






7. Write Test Specification 






8. Review Test Section 






9. Coding Task 






10. Review Coding Task 






Total Person Costs 


Cost to Go - Total Hrs 


Cost so Far = Total Hrs * 




* S/person/hr 


$/person/hr 



175 

176 2, DettaBDed Desngm 

177 > 2 A Design Overview 

1 78 The requirements for Cool ICE 1 . 1 have been grouped into the following three main areas: 

1 79 > Organize & Manage 

1 80 > Service Development 

181 > Deployment 

182 2.2 Organize & Manage 

183 

1 84 2.2.1 Maintaining Settings at System Level 

1 85 This describes the implementation of requirements #25 and #32 specified in section 1.2 plus additional 

1 86 functionality derived from the requirements. 
187 

188 New Cool ICE Admin function "System Settings" will be added to the Options Menu to provide easy 

1 89 maintenance of system settings. 
190 

191 Table for Service handler settings will be added. Report 27E contains settings for configuring the Cool ICE 

192 Service Handler:- 

1 93 - Trace - Trace On/Off 

1 94 - Availability - On-Line/Off-Line 
195 

196 When taking the Cool ICE system off the net, a message can be entered which will be displayed to the 

1 97 browser users at deployment time. 
198 

199 In addition, the "System Settings" function will also allow specifying user-defined text to be displayed as 

200 the footer of all HTML pages. The Cool ICE Page footer, which is always put on all HTML pages, can now 

201 be turned On/Off and the text can be customized 

202 2.2.2 Improved GUI Interface 

203 This describes the implementation of requirement #13 specified in section 1.2 plus additional functionality 

204 derived from the requirements. 
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205 

206 The Look and Feel of the Cool ICE Administration User Interface will be enhanced to use MS Sans Serif 

207 Non-Bold. 
208 

209 Function for creating a New Category will be enhanced to give a message after having completed creating 

210 the new category. 
211 

212 Function for creating a New Category will be enhanced to make the new category current if no other 

21 3 category is already open. 
214 

215 Function for Deleting a Category will be enhanced to give a message after having completed deleting the 

216 category. 
217 

218 Function for Removing a security profile will be enhanced to validate if the profile is allocated to any 

219 Categories or Services before allowing it to be removed. 
220 

221 The Category Export and Import functions will be enhanced to show a progress bar. 
222 

223 The Category Export function will be enhanced to verify if the path to export to already contain a 

224 previously exported category. The user will receive a warning and the option to overwrite. 
225 

226 The Category Import function will be enhanced to verify if the category to import to already contain 

227 objects. The user will receive a warning and the option to overwrite. This makes it easier to re-import a 

228 category without first removing the content. 
229 

230 Function for modifying security profile will be enhanced to modify the profile name every where it is used 

231 when the name of the profile is changed. 

232 2.2.3 Service Templates 

233 This describes the implementation of requirements #1 and #19 specified in section 1.2 plus additional 

234 functionality derived from the requirements. 
235 

236 Functions for creating and managing Cool ICE Services Templates will be added to Cool ICE 

237 Administration. This allows creating templates and subsequently allowing the service developer to create 

238 Cool ICE services based on available templates. 
239 

240 Templates provided a mechanism to share and reuse commonly used functions such as database access and 

241 HTML layouts. 
242 

243 Function "Template" for setting up templates will be added under menu item "New Repository Object". 

244 2.2.4 Importing Existing Runs 

245 This describes the implementation of requirement #12 specified in section 1.2 plus additional functionality 

246 derived from the requirements. 
247 

248 Function for Importing an existing MAPPER run and storing it in the repository as a Cool ICE Dynamic 

249 Service will be added to the Cool ICE Administration. This will allow browsing the MAPPER database for 

250 selection of the MAPPER Run to import. Option will be provided for selection of inserting standard Cool 

251 ICE Service header. 
252 

253 The function will be added as an additional option under menu item "New Repository Object", "Dynamic 

254 Service". The option will be called "Dynamic Service based on Existing Script". 
255 
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256 2.2.5 Expanded Repository Capability for Storing Objects 

257 This describes the implementation of requirements #1 and #19 specified in section 1.2 plus additional 

258 functionality derived from the requirements. 
259 

260 Functions for inserting Images and Applets and storing these as objects in the Cool ICE repository will be 

261 added to the Cool ICE Administration. This includes exporting/importing images and applets to/from the 

262 workstation. When an image or an applet stored in the Cool ICE repository is referenced from an HTML 

263 document, the object will automatically be down loaded to the browser. The Cool ICE Service Handler 

264 handles this. 
265 

266 Two new functions, "Image" and "Applet", will be added under menu item "New Repository Object". 
267 

268 In addition, a new Cool ICE System Service "Dsplmg" will be included to view an image stored in the Cool 

269 ICE Repository. The Cool ICE Menu Builder will be enhanced to automatically build a link to the new 

270 "Dsplmg" service when a GIF or JPG type object is direct accessible. This provides the capability to view 

271 images in the Cool ICE Repository just by changing the accessibility attribute to "Direct". Normally an 

272 image object will be accessible indirectly. 
273 

274 Functions for inserting Objects of any kind and storing these as objects in the Cool ICE repository will be 

275 added to Cool ICE Administration. This includes exporting/importing objects to/from the workstation. 

276 When an object stored in the Cool ICE repository is referenced, the object will automatically be 

277 downloaded to the browser. The Cool ICE Service Handler handles this. A function "Other Object" will be 

278 added under menu item "New Repository Object". 
279 

280 In addition, new function for maintaining a table of valid Cool ICE objects will be included. This allow to 

281 define the type of object and associated MIMI Type which is used at runtime when an object is downloaded 

282 via the browser to the end user workstation. A function "Object Types" will be added under menu item 

283 "Options". 

284 2.2.6 Security Enhancements 

285 This describes the implementation of requirements #1 and #2 specified in section 1 .2 plus additional 

286 functionality derived from the requirements. 
287 

288 In addition to being able to store objects of any kind in the Cool ICE repository, the existing security 

289 profile mechanism will be enhanced to allow securing any object in the repository. 
290 

291 User Registration will be enhanced to allow specifying whether a user can change password or not. Users 

292 who are allowed to change their password can do so via the browser. 
293 

294 A "Change Password" service will be accessible from the browser for those users who have been granted 

295 the right to do so. 
296 

297 A new Cool ICE System Service "Change-Password-Form" will be included to allow Cool ICE browser 

298 users to change their own password. A user must be a registered Cool ICE user and be allowed to change 

299 password in order to use the "Change-Password" service. After successfully having changed the password, 

300 the user will be required to Signon again to Cool ICE. The Cool ICE signon form will automatically be 

301 displayed. This is necessary in order to signal to the MAPPER Gateway that the password has changed. 
302 

303 A new Cool ICE System Service "SignOff ' will be included to allow Cool ICE users to sign off from Cool 

304 ICE. After Sign Off, the Cool ICE Sign-On form will be displayed. This means a user can safely leave the 

305 workstation without the workstation having a session open to Cool ICE. 

306 2.2.7 Managing Static Documents 

307 This describes the implementation of requirement #1 specified in section 1 .2 plus additional functionality 

308 derived from the requirements. 

Revision: - FS-ICE11.DOC Page 11 of 20 

August 5, 2002 
UNISYS RESTRICTED PROPRIETARY 



Feature Specification - Cool ICE 1 . 1 



309 

310 Function for inserting Static HTML Documents and storing these, as objects in the Cool ICE repository 

31 1 will be added to Cool ICE Adrninistration. This includes exporting/irnporting documents to/from the 

312 workstation. When a static document stored in the Cool ICE repository is referenced, the document will 

31 3 automatically be down loaded to the browser. The Cool ICE Service Handler handles this. 
314 

31 5 Function "Static Document" will be added under menu item "New Repository Object". 
316 

317 Importing HTML Documents has been enhanced to allow importing images being referenced by the 

318 Document. An option will be added to select that images being imported should be saved in the Cool ICE 

319 Repository. The original functionality of importing images to the Server Image Alias Directory will be 

320 maintained. 

321 2.2.8 Arranging List of Categories and Services 

322 This describes the implementation of requirement #15 specified in section 1.2 plus additional functionality 

323 derived from the requirements. 
324 

325 Functions for Arranging the list of Categories and Objects will be added to Cool ICE Administration. This 

326 provides the capability to move categories and objects around in order to specify the sequence in which 

327 they will be listed. The Menu builder uses the list of categories and services. 
328 

329 Function "Arrange Categories/Objects" will be added under menu item "Options". 
330 

331 2.2.9 Customizing Icons for Categories and Services 

332 This describes the implementation of requirement #18 specified in section 1.2 plus additional functionality 

333 derived from the requirements. 
334 

335 New attributes for specifying customized icons for Categories and services will be added to System 

336 Settings table (27E). The menu builder will use these icons when displaying menu of categories and 

337 services. Default system icons will be used when nothing has been specified. 

338 2.2.10 File Transfer between Workstation and Server 

339 This describes the implementation of additional functionality derived from the requirements. 
340 

341 Function for transferring files between the workstation and the server will be included in Cool ICE 

342 Administration. Function "File Transfer" will be added under menu item "Options". 
343 

344 The primary purpose of the function is to provide an easy way of transferring images between the service 

345 developers workstation and the web server. The function, however, will allow transfer of any files. Browse 

346 capability will be provided for selecting files in any directory on the workstation. On the server, browsing 

347 will be restricted to directories listed in the Image Directory Alias table maintained through the Image 

348 Directory Alias function. 

349 2.2.11 Drawer Browsing Capability 

350 This describes the implementation of additional functionality derived from the requirements. 
351 

352 Creating a new category will be enhanced to include a Browse button for selecting and allocating a Drawer 

353 from the Cool ICE database. 
354 

355 The browse function will display a list of drawers in the database and allow selecting an open drawer. This 

356 makes it easy for users of Cool ICE who are not yet familiar with the Cabinet/Drawer structure of the 

357 database to setup a Cool ICE category. 
358 

359 The browse function is only available for browsing a database on the local Cool ICE system. The browse 
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360 button will be disabled when selecting to create a new category on a remote Cool ICE server. 

361 2.2.12 Service Expiration 

362 This describes the implementation of additional functionality derived from the requirements. 
363 

364 Function for listing services/objects that have expired or will expire within a specified number of days will 

365 be added. 
366 

367 Function "Service/Object Expiration" will be added under menu item "Options". 

368 2.3 Sen/see Development 

369 

370 2.3.1 Additional System variables 

371 This describes the implementation of additional functionality derived from the requirements. 
372 

373 Additional Run-Time information about the environment will be made available to Cool ICE Services. The 

374 following Cool ICE system variables will be added to the System Variables section of the services input (- 

375 8) being passed to a service:- 
376 

377 - <GSysCat> Name of Cool ICE System category (f.ex.ICEADM) 

378 - <GSvrName> Name of Web Server (f ex. coolice.au.unisys.com) 

379 - <GSvrProtocol> Protocol (f ex. HTTP/ 1.0) 

380 - <GSvrPort> Server Port number (f ex. 80) 

381 - <GRemoteAddr> IP Address of client (f ex. 129.223.41.102) 

382 - <GUserAgent> Client Browser (f ex. Mozilla/3.01 (WinNT: I) 

383 - <GGatewayIn> Gateway Input File 

384 - <GInvkSignon> Invoke Signon (y/n) 

385 2.3.2 Enhanced Integration to HTML Authoring Tools 

386 This describes the implementation of requirements #4, #14 and #23 specified in section 1.2 plus additional 

387 functionality derived from the requirements. 
388 

389 Importing HTML Forms will be enhanced to modify the Form Action attribute to the standard Cool ICE 

390 way of referencing another service. "<GURL>/<category>/COOL-ICE-SERVICE" will be inserted in the 

391 action field. This means the service developer just has to modify "COOL-ICE-SERVICE" and insert the 

392 appropriate service name. 
393 

394 Exporting and Importing HTML Templates will be enhanced to allow for services that contain more than 

395 one HTML Template. If a service contain more than one HTML Template a dialog box will appear 

396 allowing the user to select which Template to export or import. 
397 

398 Importing HTML Templates or HTML Documents will be enhanced to allow importing images being 

399 referenced by the Template/Document. Optionally images can be imported and saved in the Cool ICE 

400 Repository. The original functionality of importing of images to the Server Image Alias Directory has been 

401 maintained. 
402 

403 The following additional enhancements will be implemented: 

404 - Under special circumstances importing an HTML template containing Script causes the HTML 

405 delimiters o not to be translated. 

406 - Under special circumstances importing an HTML template containing very long lines causes 

407 truncation of the HTML input. 
408 

409 Exporting HTML will be improved to make a better decision whether a line is a Cool ICE Script or an 

410 HTML Tag particular when there is no @ character in column one. 
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41 1 2.3.3 Image Maps Capability 

412 This describes the implementation of additional functionality derived from the requirements. 
413 

414 Support will be added for the HTML ISMAP's. The Cool ICE service will receive two variables (<X> and 

41 5 <Y>) containing the coordinate position of the mouse pointer when the user click within an image defined 

41 6 with the ISMAP attribute. 
417 

418 The Cool ICE Service Handler will be enhanced to create two variables (<X> and <Y>) in the service input 

419 report containing the corresponding x and y coordinate position of where the user clicked on the map. 

420 2.3.4 Creating Services based on Templates 

421 This describes the implementation of requirements #1 and #19 specified in section 1.2 plus additional 

422 functionality derived from the requirements. 
423 

424 Function for Creating a New Service Based on Cool ICE Template will be enhanced to allow the service 

425 developer to browse the repository to find and select a suitable template. 

426 2.3.5 Cookies Support 

427 This describes the implementation of requirement #28 specified in section 1 .2 plus additional functionality 

428 derived from the requirements. 
429 

430 Support for cookies will be provided. Cookies can be set by individual Cool ICE services and the cookie 

431 keywords and associated values will be passed into the Cool ICE services. Cookies will be passed into the 

432 Cool ICE services through the "-8" mechanism and is presented in the browser input section. A cookie 

433 keyword will be used as the variable name and the normal naming conventions for MAPPER variable 

434 naming will apply. 
435 

436 Example #15 and example #16 in the examples category will provided examples of how to set and re-set 

437 cookies. 

438 2.3.6 Uploading Files 

439 This describes the implementation of requirement #28 specified in section 1.2 plus additional functionality 

440 derived from the requirements. 
441 

442 Upload capability for uploading files from the client workstation via HTML Forms via the browser has 

443 been implemented. 
444 

445 When the HTML Form attribute ENCTYPE="multipart/form-data n is specified on the HTML Form tag and 

446 the TYPE-'file" is specified on the Form INPUT tag, the browser will allow the user to browse files on the 

447 workstation and attach a file to the form data being send up to the web server. 
448 

449 The following is an example of the HTML Form specifications :- 

450 [FORM ENCTYPE= M multipart/form-data" 

451 ACTION-"<Gurl>/<category>/service"METHOD=POST] 

452 Filename On Your Computer: [INPUT NAME="WsFile" TYPE="file"] 

453 [INPUT TYPE="submit" VALUE="Send File"] 

454 [/FORM] 
455 

456 In the above example the TYPE-'file" is causing TWO parameters to be passed into the Cool ICE service 

457 via the service input report (-8):- 

458 - <Wsfile> containing the name of the file on the workstation. 

459 - <FUWsFile> containing the name of the file on the server. This is the name of the File after it 

460 has been Uploaded to the server. 
461 

462 As the example indicate, Cool ICE will add the prefix "FU" (File Upload) to the name of the input field 
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463 name (WsFile). 
464 

465 An uploaded file is only stored temporarily on the server. The Cool ICE Gateway will remove the file when 

466 the receiving Cool ICE service returns a response/document to the browser. 
467 

468 The receiving Cool ICE service is expected to copy or move the file to a permanent location as appropriate 

469 for the functionality of the service. 
470 

471 Example #18 in the examples category provide an example of how to specify the HTML Form and how to 

472 receive and store the file in a Cool ICE service. 

473 23.7 Downloading Files 

474 This describes the implementation of requirement #28 specified in section 1.2 plus additional functionality 

475 derived from the requirements. 
476 

477 Downloading a text file from the server to the workstation can be achieved from a Cool ICE Service. The 

478 Cool ICE service must specify the content type of the file being passed down to the browser. The Content 

479 Type can be specified in the header of the text file as in the following example: 
480 

481 line 1, column 1: Content-Type: application/my-app 

482 line 2 data 

483 etc. more data 
484 

485 Example #19 in the example category will provide example of how a Cool ICE service creates a file for 

486 download. 

487 2A Deployment 

488 

489 2.4.1 Enhanced Session Management 

490 This describes the implementation of requirement #28 specified in section 1.2 plus additional functionality 

491 derived from the requirements. 
492 

493 Session Management will be enhanced. The Cool ICE system including the gateway has been enhanced to 

494 provide a more secure way of handling session id's. The Sessionld is no longer part of the URL. 

495 SessionlD's are kept as cookies. The cookies are created without an expiry so they are not written to disk 

496 and they only last while the browser is running. Each Sessionld is unique and is not related to any other 

497 session, past or present. Each Sessionld is paired with the TCP/IP address and is verified for every 

498 transaction. 
499 

500 For the browser user this mean that he/she can bookmark access to preferred services. When a session is 

501 established and the user select a bookmark, the system will not ask the user to signon. Only when a session 

502 is not established will the user be asked to signon. 

503 2.4.2 Controlling System Availability and System Trace 

504 This describes the implementation of requirements #25 and #32 specified in section 1 .2 plus additional 

505 functionality derived from the requirements. 
506 

507 The Cool ICE Service Handler will be updated to check for the System Setting in table 27E. When the Cool 

508 ICE system has been taken off-line a user defined system availability message will be send back to the 

509 browser user. 

510 2.4.3 Enhanced Graphics Support 

51 1 This describes the implementation of additional functionality derived from the requirements. 
512 
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513 Available Graphic Chart types will be expanded to include the following new types of charts :- 

514 - Pie, Bar, Gant, Line, Log Line, Polar, Area, Scatter, Tape and Buble. 
515 

516 List of possible chart types is available in report 6B of the Cool ICE cabinet 
517 

518 The Cool ICE Graphing Interface Routine located in 9B of the Cool ICE cabinet has been enhanced to 

519 handle a call from a remote Cool ICE service. 
520 

521 Creating Cool ICE Dynamic Graphs will be enhanced to allow specifying the size of a graph. The graphics 

522 interface routine located in 9B of the Cool ICE cabinet will be given a new entry point with additional 

523 parameters:- 

524 @002:(<ChTyp>,<Height>,<Width>,<Title>,<GphNbr>,\ 

525 <ImgPam>,<TempDir>,<TransId>,<GphImgFile>,<status>) . 
526 

527 Height and Width parameters have been added. Height and Width is specified in twip's. F.ex. a 

528 height, width of 2000,2000 equals 89, 1 34 pixels. 
529 

530 Default height, width is 5850,8600 which will be applied when no size is specified. 
531 

532 Minimum height, width is 1000, 1000. 
533 

534 Example #15 in the example category delivered with Cool ICE provides guidance for how to specify the 

535 size of a graph. 
536 

537 A STATUS parameter has been has been added to the interface routine. This is used to provide feedback to 

538 the calling service as to whether the graph was produced successful or not. The status parameter contains 

539 the value 0 (zero) when the graph is produced successful. The status parameter contains the value contains 

540 9 when an error occurred while producing the graph and the GphlmfFile parameter points to an error 

541 image. 

542 2.4.4 Positional URL Parameters 

543 This describes the implementation of requirement #26 specified in section 1.2 plus additional functionality 

544 derived from the requirements. 
545 

546 Handling of positional parameters specified on the URL will be improved. Parameters specified on the 

547 URL without keyword will be interpreted as positional parameters and the Cool ICE Service Handler will 

548 generate default keywords as follows :- 

549 Error! Reference source not found. 
550 

551 This URL will generate the following input to the service :- 

552 @ldv,p <Category>s8- Examples' . 

553 @ldv,p <Service>s5='Forml ' . 

554 @ldv,p <Paraml>s5='hello' . 

555 @ldv,p <Param2>s5- world' . 

556 2.4.5 Service Error Analyser via the Browser 

557 This describes the implementation of additional functionality derived from the requirements. 
558 

559 A new Cool ICE System Service "SvcDump" will be included to view an error dump from a service that 

560 failed. The Cool ICE Service Handler will be enhanced to display a message with a link to the new 

561 "SvcDump" when a service terminates abnormally. This gives the service developer the capability to view 

562 the service error dump using a browser. 
563 

564 The link to the "SvcDump" service will only be available if the security profile of the browser user allows 

565 access to the "SvcDump" service. 
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566 2.4.6 Additional System Variables 

567 This describes the implementation of additional functionality derived from the requirements. 
568 

569 Additional Run-Time information about the environment will be made available to Cool ICE Services. The 

570 Cool ICE Service Handler will be updated to supply the following additional Cool ICE system variables in 

571 the services input (-8) being passed to a service :- 
572 

573 - <GSysCat> Name of Cool ICE System category (f.ex.ICEADM) 

574 - <GSvrName> Name of Web Server (f.ex. coolice.au.unisys.com) 

575 - <GSvrProtocol> Protocol (f.ex. HTTP/ 1.0) 

576 - <GSvrPort> Server Port number (f.ex. 80) 

577 - <GRemoteAddr> IP Address of client (f.ex. 129.223.41.102) 

578 - <GUserAgent> Client Browser (f.ex. Mozilla/3.01 (WinNT: I) 

579 - <GGatewayIn> Gateway Input File 

580 - <GInvkSignon> Invoke Signon (y/n) 

581 2.4.7 Support for Image Maps 

582 This describes the implementation of additional functionality derived from the requirements. 
583 

584 The Cool ICE Service Handler will be updated to support the HTML ISMAP's. The Cool ICE service will 

585 receive two variables (<X> and <Y>) containing the coordinate position of the mouse pointer when the 

586 user click within an image defined with the ISMAP attribute. 
587 

588 The Cool ICE Service Handler will be enhanced to create two variables (<X> and <Y>) in the service input 

589 report containing the corresponding x and y coordinate position of where the user clicked on the map. 

590 2.4.8 Service Expiration Date Enforcement 

591 This describes the implementation of requirement #60 specified in section 1.2 plus additional functionality 

592 derived from the requirements. 
593 

594 The Cool ICE Service Handler will be enhanced to verify if a service or object being requested from the 

595 Cool ICE Repository has expired. This is utilizing the "Expiration Date" attribute. 

596 2.4.9 Automatic Object Download 

597 This describes the implementation of requirements #1 and #28 specified in section 1.2 plus additional 

598 functionality derived from the requirements. 
599 

600 The Cool ICE Service Handler will be enhanced to support downloading objects to the browser. The 

601 download will be handled transparent to service, so no special scripting is necessary. Any object stored in 

602 the Cool ICE repository will be downloaded, this can be an object such as PPTs, XLS's, DOC's, etc. A 

603 Cool ICE service just provides a link to an object using the normal HTML Anchor Tag. 
604 

605 All examples in the example category will take advantage of this feature. All examples will include a link 

606 to the "Powered by Cool ICE" image which will be stored in the Cool ICE repository. 

607 2.4.10 Image Viewer 

608 This describes the implementation of requirement #1 specified in section 1.2 plus additional functionality 

609 derived from the requirements. 
610 

611 A new Cool ICE System Service "Dsplmg" will be included to view an image stored in the Cool ICE 

612 Repository. The Cool ICE Menu Builder will be enhanced to include a link to the new "Dsplmg" service 

613 when an object is a GIF or JPG type and it is direct accessible. This provides the capability to view images 

614 in the Cool ICE Repository just by changing the accessibility attribute to "Direct". 
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615 2.4.11 User Password Change 

616 This describes the implementation of requirement #2 specified in section 1.2 plus additional functionality 

617 derived from the requirements . 
618 

619 A new Cool ICE System Service "Change-Password-Form" will be included to allow Cool ICE browser 

620 users to change their own password. A user must be a registered Cool ICE user and be allowed to change 

621 password in order to use the "Change-Password" service. 
622 

623 A new Cool ICE System Service "SignOff ' will be included to allow Cool ICE users to sign off from Cool 

624 ICE. After Sign Off, the Cool ICE Sign-On form will be displayed. This means a user can safely leave the 

625 workstation without the workstation having a session open to Cool ICE. 

626 2.4.12 Cookies Support 

627 This describes the implementation of requirement #28 specified in section 1.2 plus additional functionality 

628 derived from the requirements. 
629 

630 The Cool ICE Service Handler will be updated to support cookies. Cookies can be set by individual Cool 

631 ICE services and the cookie keywords and associated values will be passed into the Cool ICE services. 

632 Cookies will be passed into the Cool ICE services through the "-8" mechanism and is presented in the 

633 browser input section. A cookie keyword will be used as the variable name and the normal naming 

634 conventions for MAPPER variable naming will apply. 
635 

636 Example #15 and example #16 in the examples category will provided examples of how to set and re-set 

637 cookies. 
638 

639 2.4.13 Repository Search Capability 

640 This describes the implementation of requirement #22 specified in section 1 .2 plus additional functionality 

641 derived from the requirements. 
642 

643 Function for the browser user will be added to allow searching for Cool ICE services available in the Cool 

644 ICE Repository. The search engine allow search for words, phrases using wildcard (*) and boolean 

645 operators (and, or, not). 
646 

647 The result of a search will be a list of service titles that match the query. Only services that match the user 

648 security profile will be listed. 
649 

650 The Search function will be implemented as a Cool ICE service ("SearchForm"). The Search function will 

651 be accessible from the browser and available from the main Cool ICE menu. The Search function is only 

652 available if the user security profile provide access to the function. 

653 2.4.14 Event Viewer 

654 This describes the implementation of requirement #22 specified in section 1 .2 plus additional functionality 

655 derived from the requirements. 
656 

657 A Cool ICE Event Viewer will be implemented. It will provide a browser interface for viewing the Cool 

658 ICE Event Log. 
659 

660 The Event Viewer will be accessible from the main Cool ICE browser menu for users who have been 

661 granted access via the user profile security. 
662 

663 The Event Viewer will display a list of Log Report and a number of options for viewing the log 

664 information. One or more Log Reports can be selected for viewing. 



Revision: - FS-ICE 1 1 .DOC Page 1 8 of 20 

August 5, 2002 
UNISYS RESTRICTED PROPRIETARY 




Feature Specification - Cool ICE 1.1 



665 2.4.15 Uploading Files to the Repository 

666 This describes the implementation of requirement #28 specified in section 1.2 plus additional functionality 

667 derived from the requirements. 
668 

669 The Cool ICE Service Handler will be updated to provide support for File Upload as described in section 

670 23.6. 

671 2,4.16 Enhanced Handling of HTML Tag Delimiters 

672 This describes the implementation of additional functionality derived from the requirements. 
673 

674 The Cool ICE Service Handler will be updated to pass anything between [SCRIPT ...] and [/SCRIPT] as it 

675 is and NOT translate the HTML Tag delimiters from [] to o. 
676 

677 The Source Viewer service will be improved to make a better decision whether a line is a Cool ICE Script 

678 or an HTML Tag particular when there is no @ character in column one. 

679 2.5 Discontinued Functionality 

680 

681 2.5.1 Static Document Outside Cool ICE 

682 The storage of Static Documents in directories outside the Cool ICE system has been removed. This has 

683 been replaced by the new feature (Requirement #1 that provide functionality to upload and store Static 

684 Documents in the Cool ICE Repository. 
685 

686 As a result of this, functions for maintaining Document Directory Aliases has also been removed. 

687 2.5.2 Transfer Cool ICE System Images 

688 The "Transfer Cool ICE System Images" function within "Image Directory Alias" dialog has been 

689 removed. With Cool ICE 1.1 all system images are stored in the Cool ICE Repository. Cool ICE 1 . 1 will be 

690 taking advantage of the new image handling capabilities introduced with this release. System images will 

691 be stored in "ICEADM" system category. 
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The Cool ICE Administration module: 

• provides an environment for administrating a company's Internet/Intranet services 

• assists with the development of these Internet/Intranet services 

• provides capabilities for handling the deployment of Internet/Intranet services 

Cool ICE Administration is primarily targeted at service developers who will be developing, maintaining and 
enhancing Internet/Intranet services. Functions are also provided for non-technical people to publish static 
documents over the Internet/Intranet. 

The Cool ICE system is a Repository-based system that provides a single point of control for a company's 
Internet/Intranet assets. Cool ICE Administration provides a point and click environment for maintaining services 
and their categories in the Repository. 

Cool ICE Administration is implemented using Unisys's 4GL Mapper software and uses the power of Mapper for 
development as well as deployment. 

The Cool ICE on-line help contains the following main topics: 

• Categories 



Objects 



Event Viewer 



Security 
Options 



'Cool ICE 1.1 

* HDK:00001 
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$K+ Categories 

# A category is a collection of services and objects. It is a way of grouping related objects which together create an 
application, or it may be used to group related topics. 

The following illustrates the structure of categories in the Cool ICE Repository: 

Cool ICE System 
Category A 

Service A1 

Service A2 
Image 11 

Category B 
Service B1 

A category can be set up either as a local category or as a remote category. 

• A local category means that all the services and objects for the category will physically reside on the same 
server within the local Cool ICE system. 

• A remote category means that all the services and objects for the category will physically reside on a remote 
server within the Cool ICE system on that remote server, interconnected via the Cool ICE networking 
capabilities. Although a category is remote, the Repository information is kept in the central Repository on the 
local system. 

Cool ICE Administration will automatically handle the necessary networking to store and retrieve services and 
objects belonging to remote categories. 

Subtopics are: 

• New Category 

• Delete Category 

• Category Properties 

• Rename Category 

• Export Category 

• Import Category 



$ Categories 
K category 
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$K+ New Category 



^he New Category option is used to create a new category. Setting up a new category involves allocating a 
drawer in the Mapper system database as the areas for storing the services for this category. The drawer for a 
category on the local Mapper system will be generated automatically. 

Setting up a new category requires that the user have Mapper Coordinator privileges which give permissions to 
allocate and generate a new drawer in the Mapper database. 

In order to create a category on a remote Mapper Server system, the drawer for the category must have been 
allocated and generated by the coordinator of the remote Mapper system. The drawer must be generated as free 
form and 80 characters wide. 

Category Name 

A unique name to identify the category within the Repository. 
Category Title 

A 70 character long title that will be shown in the list of categories viewed from the browser. 
Category Drawer 

The Mapper cabinet and drawer to be allocated for storing the services within the category. To locate an available 
Mapper cabinet and drawer click Browse . 

Category Options 

o Cool ICE System Category: This option is used to nominate a category to be the Cool ICE System Category. 
Cool ICE requires a category to be available containing specific services related to the deployment of Cool ICE. 
A category named "ICEADM" containing default system services is delivered with Cool ICE. If an installation 
want to customize the system services, it is recommended to copy the system category to another category 
before applying modifications. This option should then be used to nominate this new category as the System 
Category for this Cool ICE system. Only one system category is allowed for a Cool ICE system. It will therefore 
be necessary to remove the system specification on the current category before nominating another category. 

o Direct accessible from menu: When checked, this identifies that the category should appear in the menu 
displayed at deployment time in the browser. 

o Available on the Net: This option allows for easily taking a whole category Off the Net while doing maintenance 
to a range of services within the category. By default, a new category is Off the Net until services are provided 
within the category, at which time the category should be put On the Net using the Category Properties option. 

o Read only: When checked, this option will identify the category as a read only category. This mean that services 
and objects in this category cannot be updated using the Cool ICE Administration functions. This is to prevent 
accidental updates to a category. 

Category Icon 

This allows to select an icon from the Cool ICE repository to be shown next to this category in the menu displayed 
at deployment time in the browser. You click on the browse button to browse and select the icon from the Cool ICE 
Repository. The Default Icon button will reset the icon to the system default. The default category icon can be 
configured using the Cool ICE System Settings function. 

Enable Remote Category 

When checked, indicates that the category is to be located on a remote Mapper system. A list of remote Mapper 
systems, which have been configured in the Networking Configuration report (1C2), will be displayed for selection. 
Cool ICE Administration will verify that the cabinet and drawer specified for the Services Drawer has been 
generated on the remote Mapper system and is empty. The coordinator of the remote Mapper system must have 
allocated and generated the drawer as a free form 80 character wide drawer. 

Enable User Authentication 
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K Availability;Category Drawer;Category lcon;Category Name;Category Title;Enable Remote 
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This is related to remote categories. When checked, it means that in order for an end user's browser to gain 
access to a service within this category, their user-id must be passed to the remote Mapper system and validated 
on the remote system. This provides a high level of security, but requires additional administration. When 
unchecked, a default user-id and password can be specified and this will then be used for all access to the services 
within the category. This user-id and password must be defined on the remote system. 



$K+ Delete Category 

*The Delete Category option is used for deleting a category. Categories located on the local Mapper system will be 
deleted from the Repository. The Mapper drawer containing the services will also be physically deleted from the 
system. For remote categories, only the Repository information will be deleted. 
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$K+ Category Properties 

^he Category Properties function allows you to select a category and view or change the properties. 



5 Category Properties 
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$K+ View Category Properties 

*The View Category Properties dialog allows you to change the Name, Title, Options and Icon of a category. 
For description of individual fields, please see New Category function. 

Category Drawer and Remote Server Location 

These cannot be changed. In order to move a category to another location, you must create a new category and 
use the Copy Service option to copy the services to the new category. 
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$K+ Rename Category 

^he Rename Category option allows the administrator to change the Repository name of a category. Cool ICE 
Administration will automatically change the name everywhere it appears in the Repository. For local categories the 
drawer name will also change where used by the Mapper system. 
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$K+ Export Category 

*The Export Category option provides an easy way of saving the services and objects of a whole category to 
another media. This can be used for exchanging a category with another Cool ICE system, or simply for backing up 
the service and object specifications for a category. 

Category to Export 

The category you want to export. 

Directory to Export to 

The directory where the category and associated service will be written to. This can be a directory on the hard drive 
of your local workstation, or simply a diskette on your workstation for easy exchange with another Cool ICE 
system. A directory can only contain one exported category. If attempting to export to a directory already containing 
a category, a warning will be given and you will receive the option to overwrite. 

Cool ICE Administration will export all the Repository information for the category and the associated services and 
objects and will export the service specifications themselves including any associated Style Guide information. 
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$K+ Import Category 



The Import Category option will import a category that previously has been exported from another Cool ICE 
system. 

Category to Import into 

This must be an empty category. Cool ICE Administration will import all services and objects included in the 
category. If you only want to import selected services, we recommend that you import the category to a temporary 
category and then use the Copy Service option to copy the selected services from there. If the category to import 
into already contains objects, you will receive a warning and the option to overwrite. The import function will use the 
original database report number and replace objects in the same database report number. 

Directory to Import from 

This is the directory where the category was previously exported to. This can be a directory on the hard drive of 
your local workstation, or simply the diskette drive on your workstation. 
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$K+ Objects 

# Object is a common term for those services and objects you are keeping in the Cool ICE Repository and is 
providing on the Internet/Intranet. 

An object can be one of the following: 

• Documents with static content such as company information and product descriptions 

• Inquiry forms and fill in forms such as order entry forms 

• Dynamic services providing access to databases and building HTML documents dynamically 

• Service Templates for assisting the service development containing commonly used script methods. 

• Images and icons 

• Applets 
Subtopics are: 

• Object Attributes 

• New Repository Object 

• Open Repository Object 

• Close Repository Object 

• Save Repository Object 

• SaveAs Repository Object 

• Copy Repository Object 

• Delete Repository Object 

• Rename Repository Object 
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$K+ Object Attributes 



The attributes of an object are stored in the Cool ICE Repository together with its actual object/service 
specifications. You can use the Object Attributes dialog to modify these attributes. This dialog will be displayed 
when opening an existing service or starting a new service . 

You specify the name of a new object when you save it to the Repository. 
Object 

This is the repository name of the object. It is specified when you save the object to the repository. 
Category 

This is the category to which the object belong within the repository. The category is specified when you save the 
object to the repository. 

Location 

An indicator for the physical database location of the object. This is determined by the system when you save the 
object to the repository. 

Object Type 

Indicator that show the type of the object. The object type is determined when creating a new object and cannot be 
changed. 

Object Title 

A 70 character long title that will be shown in the list of objects/services viewed from the browser. 
Availability 

An option for easily taking an object/service Off the Net while updating the object. By default, a new service is Off 
the Net until service specifications have been updated, at which time the service should be put On the Net. 

Expiration Date 

Specifies when the object becomes unavailable to the browser users. On or after the date specified, browser users 
who attempt to request the object will receive a message indicating the object is no longer available. 

Access to Object 

Identifies how the browser user can access the object. Menu means that this object is a service which is 
responsible for displaying the menu of available services to the browser. When Menu is not chosen, the system will 
build and display a default menu of available objects within a category. Direct means a link to the object will be 
provided in the default menu built and displayed by the system. In-Direct means the object can only be requested 
indirectly from other services/objects. 

Object Icon 

This allows to select an icon from the Cool ICE repository to be shown next to this object in the menu displayed at 
deployment time in the browser. You click on the browse button to browse and select the icon from the Cool ICE 
Repository. The Default Icon button will reset the icon to the system default. The default object icon can be 
configured using the Cool ICE System Settings function. 

Object Specifications 

The content of this frame will vary depending on the type of object: 
Service Specifications. 

This frame will be displayed when the object type is Dynamic. By clicking on the document icon you will get 
access to the service specifications. The service specifications are Cool ICE Scripting functions. The service is 
displayed as a Cool ICE Database result report and can be edited using Cool ICE Database editing functions. 
Normal rules for editing a Cool ICE Database result report apply which for example means that the content of 
the current displayed report at the time you return will be returned to Cool ICE Administration and will be 
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regarded as updates to the service. Using functions such as Find or Locate should be avoided as they are 
native Cool ICE Database functions and causes that you cannot return to Cool ICE Administration. 

Trace On 

Provides a powerful debugging aid for tracing problems in a dynamic service. When turned on, the service 
request from the browser, including all input to the service, will be saved in a trace log . 

Export HTML 

If the template contain HTML, this is used to export the HTML to be maintenance by an HTML Authoring 
tool. 

Import HTML 

Used for importing HTML from an HTML Authoring tool to the service. 
Document Specifications 

This frame will be displayed when the object type is Static Document. By clicking on the Modify Document icon 
you will get access to the document specifications. The document is displayed as a Cool ICE Database result 
report and can be edited using Cool ICE Database editing functions. Normal rules for editing a Cool ICE 
Database result report apply which for example means that the content of the current displayed report at the 
time you return will be returned to Cool ICE Administration and will be regarded as updates to the service. 
Using functions such as Find or Locate should be avoided as they are native Cool ICE Database functions and 
causes that you cannot return to Cool ICE Administration. 

Export Document 

This is used to export the Document to be maintenance by an HTML Authoring tool. 
Import Document 

Used for importing a Document from an HTML Authoring tool to the document. 
Image Specifications 

This frame will be displayed when the object type is Image. 
Export Image 

This will export the image to a file on your workstation. You can the open and edit the image by an Image 
Editor tool. 

Import Image 

Used for importing an image from a workstation file and replace the current image. 
Template Specifications. 

This frame will be displayed when the object type is Template. By clicking on the Modify Template icon you will 
get access to the template specifications. The template specifications are Cool ICE Scripting functions. The 
template is displayed as a Cool ICE Database result report and can be edited using Cool ICE Database editing 
functions. Normal rules for editing a Cool ICE Database result report apply which for example means that the 
content of the current displayed report at the time you return will be returned to Cool ICE Administration and 
will be regarded as updates to the service. Using functions such as Find or Locate should be avoided as they 
are native Cool ICE Database functions and causes that you cannot return to Cool ICE Administration. 

Export HTML 

If the template contain HTML, this is used to export the HTML to be maintenance by an HTML Authoring 
tool. 

Import HTML 

Used for importing HTML from an HTML Authoring tool to the template. 
Applet Specifications 

This frame will be displayed when the object type is Applet. 
Export Applet 

Exporting an applet is not available. 
Import Applet 

Used to import an updated version of the applet from a workstation file. 



$K+ New Repository Object 

*The following is a list of different objects you can insert in the Cool ICE Repository: 

• Dynamic Service 

• Image 

• Applet 

• Template 

• Static Document 
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Dynamic Service 



^TThe Dynamic Service option starts the creation of a new dynamic service. The following options for new dynamic 
services are available: 

Dynamic Service based on Cool ICE Script Template 

Opens a dialog box providing access to browse the Cool ICE repository to select an appropriate template which 
you want to use as the basis for the new dynamic service. 

Dynamic Service based on HTML Template 

Allows the service developer to combine the use of HTML authoring tools with the Cool ICE Scripting development 
environment. This will import templates previously created with an HTML authoring tool into the Cool ICE service 
run to form the basis for developing a dynamic service. Inquiry Forms, Input Forms and Output Tables are 
examples of HTML templates able to be developed using an authoring tool. 

Dynamic Service based on existing script 

Allows to browse the Cool ICE database to select an existing script report which you want to use as the basis for 
developing a new dynamic Cool ICE service. 
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Select Template 



*The Select Template function allows you to browse the Cool ICE Repository selecting a Cool ICE Template object. 
Only objects previously inserted into repository as Cool ICE Templates using the new template function will be 
listed. 

Use default Cool ICE Template 

When checked, this option will select the Cool ICE default template. This template contains the very basic format 
for a Cool ICE dynamic service which is the format all Cool ICE services must conform to. 
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$K+ lmport HTML Template 

^he Import HTML Template option is associated with the Dynamic Service based on HTML Template option, 
which you can select when creating a new dynamic service . The following describes what happens during the 
import process: 

o HTML tags are mapped to the Cool ICE Style Guide. The HTML template is scanned and selected HTML tags 
and attributes are translated into the equivalent Style Guide keywords. The mapping between the HTML tags 
and Style Guide keywords is described in table 30E. Maintenance of this table is only provided through the use 
of manual Mapper editing options. 

o Images are uploaded to the Web Server. The HTML template is scanned for references to images which are 
then transferred to either the Cool ICE Repository or the image directory on the web server. 

o Long lines are automatically wrapped. Lines longer than 80 characters are wrapped at a space or at the end of 
an HTML tag. When that is not possible, a line will be broken at column 80 and continued on the next line. 

o Essential Mapper run statements are inserted. The necessary Mapper run statements to turn the HTML 
template into a dynamic service and to interface to the Cool ICE system are inserted at the top and bottom of 
the template. 

o HTML tag delimiters are converted. HTML tag delimiters (less than and greater than) are converted to opening 
and closing square brackets. This is to avoid confusion with the standard Mapper variable name delimiters (less 
than and greater than). These delimiters will automatically be converted back by the Cool ICE Service Handler 
before a document is sent to the browser. 

o Anything between <SCRIPT...> and </SCRIPT> such as JavaScript or VBScript which is not Cool ICE script will 
be passed untouched. JavaScript/VBScript typically contain special characters such as <> and Q and special 
characters like these will not be converted. 

o The Action attribute on the HTML FORM tag will be modified to the Cool ICE standard for referencing another 
service from an html form. <GUrl>/<category>/COOL-ICE-SERVICE will be inserted in the action field. This 
means the service developer just have to modify and replace COOL-ICE-SERVICE with the appropriate Cool 
ICE service name. 

Workstation HTML File 

Specifies where on your local workstation the HTML template is to be imported from. 
Browse 

Allows you to browse through directories to find the HTML template. 

Map HTML Tags to Cool ICE Style Guide 

Allows you to turn the mapping to the Style Guide on and off. 

Upload Images 

Allows you to turn uploading of images referenced within the HTML template on and off. Based on the reference to 
the image as specified in the HTML tag <IMG>, Cool ICE will attempt to determine the location of the image. If the 
image resides on a drive not accessible from your workstation, you will be asked to specify the exact location or 
skip the upload . If the image file already exists on the server you will be asked to confirm replacing the image. 
Multiple references to the same image are not detected and you will be asked to confirm replacing the image. 

The following option are available for uploading images: 

o Save in Cool ICE Repository. This means that images being uploaded to the server will be inserted in the Cool 
ICE repository. This option is recommended to use when you want to manage images by the Cool ICE 
Administration environment for things like securing, backing up and exporting/importing images. When selecting 
this option you will be allowed to specify in which Cool ICE Repository Category to save the uploaded image . 
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Save in Server Directory. This mean that images being uploaded to the server will be inserted in an image 
directory on the server outside of the Cool ICE database. This option is recommended to use when 
performance of sending images to the browser is more important than managing the images by the Cool ICE 
Administration environment. When selecting this option you will be allowed to select the directory to upload the 
image to. A list of valid server image directories is displayed for selection. 



Import Existing Script Report 



*The Import Existing Script Report option allows you to browse the Cool ICE database to select an existing 
database report to be used as the basic for a new dynamic Cool ICE service. 

Script Report Location 

This allows you to specify the location of an existing script report. If you know the report identification you can 
specify it directly. The Browse button allows you to browse the Cool ICE database and select an existing report. 

Apply default Cool ICE script envelope 

When checked the standard Cool ICE script envelope will be applied to the script report. The script envelope is 
Cool ICE script statements necessary for a dynamic service to interface to the Cool ICE run time environment. 
Script will be inserted at the top and bottom of the script report. 
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$K+ Upload Image File 

"The Upload Image File dialog is displayed when the upload process of an HTML template cannot determine the 
location of an image to be transferred from the workstation to the Web server. 

You are asked to identify the location of the image or skip upload of this image. 
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$K+ Save Uploaded Object 

# As a result of uploading images to the Cool ICE repository this dialog box will appear asking you to select in which 
category you want to insert the image and you are asked to provide the Object Name. 

Cancel 

Selecting the cancel button will skip the upload of the image. 
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$K+ lmport Image 

^he import Image function is used when inserting a new image in the Cool ICE Repository and when importing 
new revision to replace an existing image in the Cool ICE Repository. 

Workstation Image File 

Specifies where on your local workstation the image is to be imported from. 
Browse 

Allows you to browse through directories to find the image file. 
Image Type 

Allow you to specify the type of image if it is different from the file extension. 
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$K+ lmport Applet 

^he Import Applet function is used when inserting a new applet in the Cool ICE Repository and when importing 
new revision to replace an existing applet in the Cool ICE Repository. 

Workstation Applet File 

Specifies where on your local workstation the applet is to be imported from. 
Browse 

Allows you to browse through directories to find the applet file. 



$ Import Applet 
K Import Applet 
♦ HDK:00025 



# HDK3B9ACF00 



$K+ lnsert Template 

*The Inserting Template function is used when inserting a new template in the Cool ICE Repository. You are 
allowed to browse through the Cool ICE Repository to select an existing service or template to be used as the 
basic for the new template. 
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$K+ Import Static Document 

*The Import Static Document option is associated with the New Repository Object option. The following describes 
what happens during the import process: • 

o Images are uploaded to the Web Server. The HTML document is scanned for references to images which are 
then transferred to either the Cool ICE Repository or the image directory on the web server. 

o Long lines are automatically wrapped. Lines longer than 80 characters are wrapped at a space or at the end of 
an HTML tag. When that is not possible, a line will be broken at column 80 and continued on the next line. 

o Because this is a static document, no Cool ICE Script functions are inserted. 

o HTML tag delimiters are not converted. 

Workstation HTML File 

Specifies where on your local workstation the HTML document is to be imported from. 
Browse 

Allows you to browse through directories to find the HTML document. 
Upload Images 

Allows you to turn uploading of images referenced within the HTML document on and off. Based on the reference 
to the image as specified in the HTML tag <IMG>, Cool ICE will attempt to determine the location of the image. If 
the image resides on a drive not accessible from your workstation, you will be asked to specify the exact location or 
skip the upload . If the image file already exists on the server you will be asked to confirm replacing the image. 
Multiple references to the same image are not detected and you will be asked to confirm replacing the image. 

The following option are available for uploading images: 

o Save in Cool ICE Repository. This means that images being uploaded to the server will be inserted in the Cool 
ICE repository. This option is recommended to use when you want to manage images by the Cool ICE 
Administration environment for things like securing, backing up and exporting/importing images. When selecting 
this option you will be allowed to specify in which Cool ICE Repository Category to save the uploaded image . 

o Save in Server Directory. This mean that images being uploaded to the server will be inserted in an image 
directory on the server outside of the Cool ICE database. This option is recommended to use when 
performance of sending images to the browser is more important than managing the images by the Cool ICE 
Administration environment. When selecting this option you will be allowed to select the directory to upload the 
image to. A list of valid server image directories is displayed for selection. 
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Export HTML 



^he Export HTML option is used when you want to use an HTML authoring tool for maintaining and updating the 
HTML template within a service. The HTML section of the service will be exported to a file on your workstation. 
This file can then be opened in the authoring tool and updated using features of that tool. When finished the 
template should be saved to the file ready for being imported back into the service. 

Everything within the service between the start and end HTML tag ([HTML] and [/HTML]) will be exported. Any 
Mapper scripting options will be included and identified using the HTML script tag [SCRIPT] and associated end tag 
[/SCRIPT]. The position of script options relative to HTML tags should be maintained when updating the HTML 
template using the authoring tool. If required, the script options can be updated using the authoring tool as all of the 
HTML template including script options will be imported back into the service using the Import HTML option. 

Any script language such as JavaScript or VBScript identified between [SCRIPT...] and [/SCRIPT] will be passed 
untouched. JavaScript/VBScript typically contain special characters such as <> and □ and special characters like 
these will not be converted. 

In case the Dynamic Service you are exporting from contain more than one HTML template, a dialog box will 
appear requesting you to identify and select which of the HTML templates you want to export. 

References to the Style Guide within the HTML template will be replaced with their respective values from the Style 
Guide for the current service. 

Workstation HTML File 

Specifies where on your local workstation the HTML template is to be exported to. 
Browse 

Allows you to browse through directories to find a file name. 
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$K+ lmport HTML 

The Import HTML option is used for importing an HTML template into the current open service after having 
exported it for editing in an authoring tool. The HTML template being imported will replace everything within the 
current open service between the start and end HTML tag ([HTML] and [/HTML]). The following describes what 
happens during the import process: 

o HTML tags are mapped to the Cool ICE Style Guide. The HTML template will be scanned and selected HTML 
tags and attributes translated into the equivalent Style Guide keywords. The mapping between the HTML tags 
and Style Guide keywords is described in table 30E. Maintenance of this table is through the use of manual 
Mapper editing options. 

o Images are uploaded to the Web Server. The HTML template is scanned for references to images which are 
then transferred to either the Cool ICE Repository or the image directory on the web server. 

o Long lines are automatically wrapped. Lines longer than 80 characters are wrapped at a space or at the end of 
an HTML tag. When that is not possible, a line will be broken at column 80 and continued on the next line. 

o HTML tag delimiters are converted. HTML Tag delimiters (less than and greater than) wi!l be converted to 
opening and closing square brackets. This is to avoid confusion with the standard Mapper variable name 
delimiters (less than and greater than). These delimiters will automatically be converted back by the Cool ICE 
Service Handler before a document is sent to the browser. 

o Anything between <SCRIPT...> and </SCRIPT> such as JavaScript or VBScript which is not Cool ICE script will 
be passed untouched. JavaScript/VBScript typically contain special characters such as <> and Q and special 
characters like these will not be converted. 

o The Action attribute on the HTML FORM tag will be modified to the Cool ICE standard for referencing another 
service from an html form. <GUrl>/<category>/COOL-ICE-SERVICE will be inserted in the action field. This 
means the service developer just have to modify and replace COOL-ICE-SERVICE with the appropriate Cool 
ICE service name. 

In case the Dynamic Service you are importing to contain more than one HTML template, a dialog box will appear 
requesting you to identify and select which of the HTML templates you want to replace. 

Workstation HTML File 

Specifies where on your local workstation the HTML template is to be imported from. 
Browse 

Allows you to browse through directories to find the HTML template. 

Map HTML Tags to Cool ICE Style Guide 

Allows you to turn the mapping to the Style Guide on and off. 

Upload Images to Web Server 

Allows you to turn uploading of images referenced within the HTML template on and off. Based on the reference to 
the image as specified in the HTML tag <IMG>, Cool ICE will attempt to determine the location of the image. If the 
image resides on a drive not accessible from your workstation, you will be asked to specify the exact location or 
skip the upload . If the image file already exists on the server you will be asked to confirm replacing the image. 
Multiple references to the same image are not detected and you will be asked to confirm replacing the image. 

Server Image Directory 

Identifies the directory on the Internet/Intranet server to which the image should be transferred. A list of valid server 
image directories is displayed. 
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Select HTML Template 

*The Select HTML Template dialog box appears when a dynamic service contains more than one HTML template. 
When exporting HTML from a dynamic service or importing HTML to a dynamic service containing more than one 
HTML template, you will be asked to identify which HTML Template you want. 
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$K+ Export Document 

^he Export Document option is used when you want to use an HTML authoring tool for maintaining and updating 
the static HTML document. The HTML document will be exported to a file on your workstation. This file can then be 
opened in the authoring tool and updated using features of that tool. When finished the document should be saved 
to the file ready for being imported back into the Cool ICE Repository. 

Workstation Document File 

Specifies where on your local workstation the HTML Document is to be exported to. 
Browse 

Allows you to browse through directories to find a file name. 
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$K+ Export Image 

"The Export image option is used when you want to use an Image Editing tool for editing the image. The Image will 
be exported to a file on your workstation. This file can then be opened in the Image Editor and updated using 
features of that tool. When finished the image should be saved to the file ready for being imported back into the 
Cool ICE Repository. 

Workstation Image File 

Specifies where on your local workstation the Image is to be exported to. 
Browse 

Allows you to browse through directories to find a file name. 
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Open Repository Object 



^he Open Object option allows you to browse the Cool ICE Repository for selecting an object to open. The object 
will be issued and locked to your workstation. Any other workstation attempting to open the same object will get a 
message indicating that the object is already issued to your workstation. Objects located within remote categories 
will automatically be pulled across from the remote system and presented on your workstation. Also, remote 
objects will be locked to the workstation opening the object. 

Read Only 

Allows the developer to open an object that is locked to another workstation in read only mode. If an object opened 
in read only mode is modified, it can only be saved in the Repository under a new name. 
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$K+ Close Repository Object 

*The Close Object option releases the object which is currently open and locked to your workstation. It will verify if 
the object attributes including object specifications have changed and if necessary save the object back into the 
Repository and close the Object Attributes dialog. 
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$K+ Save Repository Object 

^he Save Object option saves changes to object attributes including object specifications back into the Repository. 
The object remains locked to your workstation. 



$ Save Repository Object 
K Save Repository Object 

* HDK:00030 

* HDK3B9ACB70 




$K+ SaveAs Repository Object 

^he SaveAs Object option allows you to save an object under a new name and also specify in which category the 
object will be saved. 
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$K+ Copy Repository Object 

*The Copy Object option allows you to copy one or more objects from one category to another or within the same 
category. 

The object attributes and object specifications, including associated Style Guide objects, will be copied. 

Cool ICE Administration provides copying to and from remote categories and will automatically handle all the 
necessary networking between remote servers. Copying directly between two remote categories is not supported. 
In order to copy from one.remote category to another remote category we recommended that you create a 
category on the local system to be used for temporary intermediate storage. 

Copy From 

Allows you to browse through categories. Within a category, you may select one or more services to copy by 
highlighting the objects in the list. 

Select All 

Used for selecting all objects in a category. The objects in the list will not be highlighted but they will all be selected 
for copying and will appear in the Confirm Copy Object dialog. 

Copy To 

Allows you to select the category to which you want to copy the objects. 
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$K+ Confirm Copy Object 

^he Confirm Copy Object dialog allows you to confirm copying of all selected objects or of individual objects from 
the list. 

Yes 

Confirms copying the highlighted object only. 
Yes to All 

Confirms copying all the objects in the list. 
No 

Removes an object from the list. 
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$K+ Confirm Replace Object 

^he Confirm Replace Object dialog is displayed in case an object name already exists in the category being 
copied to. 

Replace 

Allows you to confirm Replace. The existing object will be overwritten. 
Replace All 

Allows you to confirm Replace for all objects. All existing objects with duplicated names will be overwritten. 
No 

Skips copying the object. 
New Name 

Allows you to specify a new name for an object with a duplicated name. 
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$K+ Delete Repository Object 

^he Delete Object option allows you to delete one or more objects from a category. 

Browse through available categories and select a category. Within a category, select one or more objects to delete 
by highlighting the objects in the list. 

Select Ail 

Used for selecting all objects in a category. The objects in the list will not be highlighted but they will all be selected 
for deletion and will appear in the Confirm Delete Object dialog. 
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$K+ Confirm Delete Object 

*The Confirm Delete Object option allows you to confirm deletion of all selected objects or remove individual 
objects from the list. 

The object attributes and object specifications, including associated Style Guide objects, will be deleted. 
Yes 

Confirms deleting the highlighted object only. 
Yes to All 

Confirms deleting all the objects in the list. 
No 

Removes an object from the list. 
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$K+ Rename Repository Object 

"The Rename Object option allows you to change the Repository name of an object. 

Browse through available categories and select a category. Within a category, select the object to rename by 
highlighting the object in the list. 
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$K+ Confirm Rename Object 

The Confirm Rename option allows you to specify a new name for the object. The name of the object will be 
changed wherever it is used within the Cool ICE Repository. 
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$K+ Event Viewer 

*The Event Viewer option allows you to view events logged by Cool ICE. The following types of event logs are kept: 

• Access Log . Logs all requests for services made from a browser. 

• Error Log . Logs any service failure due to a syntactical error in the service specifications. 

• Trace Loo . Records information for services that have the Trace On attribute checked. 
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$K+ Access Log 

^he access log stores details of service requests made from a browser and logged by Cool ICE (who requested 
the service, when was the service requested, and how long did it take for Cool ICE to execute the service). Some 
uses for this information are as follows: 

• It can provide details of the services that are of most interest to users, which can be used for marketing 
purposes. 

• It can be used to charge for Internet services. 

• It can provide details about when the server is busy. 

The Access Log option has the following suboptions for specifying both the time period you wish to analyze and 
how you want to view the information: 

• Access Log Settings 

• View Access Log 
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Access Log Settings 



*The access log is maintained on a daily basis. A new log report is allocated each day, and will contain all service 
requests logged for that day. At the first service request of a new day, Cool ICE will summarize the log data of the 
previous day and add the data to a summary report. 

This summary report is kept at report 8F within the drawer where Cool ICE is installed. Access to the information in 
the summary report is not provided by any specific Cool ICE Administration option, but it can be accessed through 
Mapper for individual customized analysis. 

The log cycle can be configured as follows: 

• Daily Cycle. The Log report will be overwritten every day. 

• Weekly Cycle. Log reports will be kept on a weekly basis. 

• Monthly Cycle. Log reports will be kept on a monthly basis. 

• Logging Off. Logging is turned off and service requests will not be recorded. 
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$K+ View Access Log 

*The View Access Log option allows you to select the day you want to analyze and how you want to view the 
information. 

The following standard views are provided: 

• Most Popular Services 

• Average Service Times 

• User Sessions 

• Services by User 

• Users by Service 

• Peak Time Hits 
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$K+ Most Popular Services 

^his option provides a summary of the number of hits (service requests) per category and service. The Cool ICE 
Sign-On service is excluded from the list. 
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$K+ Average Service Times 

^This option provides the average service time per category and service. This is the elapsed time it took to perform 
the service. It is measured from the time at which the Cool ICE Service Handler received the request to the time at 
which it sent the HTML document back to the Web Server. The Cool ICE Sign-On service is excluded from the list. 
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$K+ User Sessions 

''This option provides a summary of Cool ICE sessions initiated by the users. 



$ User Sessions 
K User Sessions 

* HDK:00045 

* HDK3B9ACC60 




$K+ Services by User 

^his option provides a summary of the number of hits (service requests) per category and service listed by user- 
ids. The Cool ICE Sign-On service is excluded from the list. 
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$K+ Users by Service 

*This option provides a summary of the number of hits (service requests) per user-id listed by category and 
service. The Cool ICE Sign-On service is excluded from the list. 
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$K+ Peak Time Hits 

"This provides a list of the total number of hits (service requests) for the selected time interval. The default time 
interval is 60 minutes. You can also select 30 and 15 minute intervals. 
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Error Log 



Whenever a service fails because of a syntactical error in the service specifications, the error will be logged in an 
error log by Cool ICE. The error log provides the service developer with a lot of information about the service at the 
time it failed (the date and time of the failure, who requested the service and internal values from the service). 

The View Error Log option displays entries in the error log. 
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$K+ View Error Log 

*The View Error Log option displays the entries recorded in the error log . Selecting a log entry from the list will 
show the information logged for the incident. 

View 

Shows the log information for the entry highlighted in the list. 
Delete 

Deletes the log entry highlighted in the list. 
Clear All 

Deletes all log entries in the list. 

Log entries are not deleted automatically by Cool ICE. After the service developer has investigated the incident 
they must delete it. 
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$K+ Trace Log 

^he Trace Log option is a powerful debugging aid for the service developer who needs to trace and debug a 
dynamic service in order to analyze a problem. Services requested through the browser are executed in 
background mode and only output in HTML format can be viewed by the browser. The service developer therefore 
normally has no means of tracing and debugging a service in the browser environment. 

The trace log enables the service developer to run a service in foreground using the standard Mapper debugging 
facilities, such as the Run Debugger, as well as the simple Display options. 

The trace log is associated with the Trace On feature within the Service Attributes dialog. When turned on, Cool 
ICE will log all the input for a service each time it is requested by the browser. When the service request and all 
input is captured, the service can be run in the foreground, simulating the input coming from a browser. 

The View Trace Log option displays entries in the trace log. 
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:+ View Trace Log 



*The View Trace Log option displays entries in the trace log . Selecting a log entry from the list will show the 
information logged for the incident. 

View 

Shows the log information for the entry highlighted in the list. 
Run It 

Opens a dialog for running normal Mapper foreground runs, and runs the service as a foreground run. Prior to this, 
the service developer should have updated the service specifications to include appropriate debugging options 
such as RDB and DSP. 

Delete 

Deletes the log entry highlighted in the list. 
Clear All 

Deletes all log entries in the list. 

Log entries are not deleted automatically by Cool ICE. After the service developer has investigated the incident 
they must delete it. 
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Security 



# Cool ICE provides security at run time when services are requested from browsers. At run time, the security profile 
of the user is matched with the security profile of the service being requested. If the profiles match, the user will be 
allowed to perform the service. 

The basic concept is that only certain users need to be registered in the system — this approach reduces the 
administrator burden. 

The security mechanism has been designed for ease of maintenance. By default, the system is open and services 
can be requested by everyone with access to Cool ICE. Only for those services where restrictions apply will it be 
necessary to specify a security profile — a matching profile must be allocated to those users, who will be granted 
permission. 

Security profiles can be specified at the system, category or service level. Profiles specified at a certain level will 
automatically be inherited by services below that level. Security profiles at the system level will apply to all services 
in the whole system. Security profiles specified for a category will apply to all services within that category. Security 
profiles specified for a service will only apply to that service. 

Procedure for setting up security 

1 . Create security profiles 

2. Register users and assign profiles to users through profile membership 

3. Allocate profiles to individual Categories or Services 



The following is a list of security maintenance options: 

• Security Profiles 

• User Registration 

• Services Access Security 



$ Security 
K Security 
+ HDK:00053 
* HDK3B9ACCE0 



$K+ Security Profiles 

^he Security Profiles option is used for setting up a table of valid profiles to be allocated to users and services. A 
profile must be specified in the Security Profile table before it can be allocated. 

Add 

Opens a dialog for adding a new profile to the list. 
Modify 

Opens a dialog for modifying the description for the highlighted profile. 
Remove 

Deletes the highlighted profile from the list. A profile can only be deleted if it is not allocated to any users or 
services. 

Allocate Profile 

Allows a profile to be allocated to a range of users. 
Where Used 

Displays a report of how the profiles have been allocated . 
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$K+ Add-Modify Security Profile 

*The Add-Modify Security Profile option dialog allows you to add or modify a security profile. 
Profile 

The name of the profile to add or modify. 
Description 

A short description of the profile. 
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$K+ Security Profiles Where Used 

^he Security Profiles Where Used option provides an overview of the profiles and how they have been allocated to 
users and categories/services. 

Profile Allocation 

Opens the Profile Allocation dialog, allowing you to allocate the highlighted profile to a range of users. This dialog is 
also displayed by double clicking on a profile in the list. 
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$K+ Security Profile Allocation 

*The Security Profile Allocation option allows you to allocate or de-allocate a profile to a range of users. 
Add 

Takes users highlighted in the Not Allocated to list and adds them to the Allocated to list. 
Remove 

Removes users highlighted in the Allocated to list and puts them back in the Not Allocated to list. 
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$K+ User Registration 

"The User Registration option is used for registering users for whom special security profiles need to be allocated. 

Not all users need to be registered to use Cool ICE. Users that are not registered in Cool ICE will be allowed 
access to ail open services. A service is open, if it does not have special security profiles allocated. 

Users who have been registered and have been give membership of selected profiles, will be given access to all 
open services and services with a matching profile. 

Add 

Opens a dialog for adding a new user to the list. 
Modify 

Opens a dialog box allowing you to modify the user registration of the user highlighted in the list. 
Remove 

Deletes the highlighted user id from the list. 
Profile Membership 

Allows you to give a user membership of a range of profiles. 
Profile Report 

Displays a report of the users and the profiles they are members of and the categories/services they have been 
granted access to. 
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$K+ Add=ft/iodiiFy User Registration 

*The Add-Modify User Registration option dialog is used for adding new Cool ICE users to the list of authorized 
users. 

User Id 

The user-id to add. This can be selected from the list of users registered in the Mapper environment. A Cool ICE 
user must be a registered user of the Mapper system. If a user is not yet a registered user in the Mapper 
environment, Cool ICE Administration will automatically perform the registration with a default set of permissions; 
enough to allow the user to use Cool ICE. 

Department 

The department number in which this user is registered within the Mapper environment. A department is a way of 
grouping users with common interests. 

User cannot change password 

Checking this option means the user will not be able to change their password. It is strongly recommended that you 
check this option for general public userid's (e.g., Guest). When this option is unchecked, the browser user will be 
able to change their password by selecting the "Change Password" function from the main Cool ICE browser 
window. 
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$K+ User Security Profile Report 



*The User Security Profile Report option dialog provides an overview of the users and the profiles they are member 
of and which categories/services they have been granted special access to. 

Profile Allocation 

Opens the Profile Membership dialog, allowing you to give the highlighted user membership to a range of profiles. 
This dialog is also displayed by double clicking on a user in the list. 
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$K+ User Security Profile Membership 

*The User Security Profile Membership option dialog allows you to give a user membership of a range of profiles or 
to take profile memberships away from a user. 

Add 

Adds profiles highlighted in the Not Member of list to the Member of list. 
Remove 

Remove profiles highlighted in the Member of list and puts them back in the Not Member of list. 
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$K+ Object Access Security 

^he Object Access Security option is used for allocating security profiles for selected objects for which special 
security is required. 

Not all objects need to be allocated profiles in order to be accessible by users. All users will be given access to all 
open objects. An object is open if it does not have special security profiles allocated. 

Objects which have been allocated profiles will only be accessible by users with a matching profile. 
Inheritance Hierarchy 

This is used for selecting the level at which you wish to specify security. Security can be specified at different 
levels: a specific object, a category, or the whole system. Security specified at the system level will automatically 
apply to all objects in the whole system. Security specified for a selected category will only apply to objects within 
that category. Security specified for a single object will only apply to that object. 

Add 

Opens a dialog box for adding a profile to the list. 
Modify 

Opens a dialog box for modifying the highlighted profile entry. 
Remove 

Deletes the highlighted profile entry. 
Re-Inherit 

Resets a profile with the profile defined for the level above it in the hierarchy. 
Profile Report 

Displays a report of the categories and objects showing the security profiles which have been allocated and the 
user who have been granted access. 
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$K+ Add-Modify Object Access Security 

*The Add-Modify Object Access Security dialog is used for adding or modifying profiles for authorized access to an 
object. 

The Profile 1 , Profile 2 and Profile 3 columns allow you to select the profiles to be allocated. This is a list of valid 
profiles created using the Security Profile option. You can specify how the profiles are to be matched against the 
user profiles. You can also specify logical and/or conditions, as follows: 

• Selecting and inserting 'Real Estate' from Profile 1 and also selecting and inserting 'Solicitor' from the same 
Profile 1 , ensures that this object can be accessed only by users who are 'RealEstate' or by users who are 
'Solicitor'. 

• Selecting and inserting 'RealEstate' from Profile 1 and 'Solicitor' from Profile 2, this object can be accessed only 
by users who are 'RealEstate' and 'Solicitor'. 
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$K+ Object Security Profile Report 

^he Object Security Profile Report option dialog provides an overview of the categories and objects and the 
profiles which have been allocated and which users have been granted special access. 
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$K+ Options 

^he Options menu provides the following options for configuring Cool ICE: 

• Style Guide 

• Arrange Cateaories/Obiects 

• Image Directory Aliases 

• Browser SianOn Configuration 

• Cool ICE System Settings 

• Graphics Server Settings 
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$K+ Style Guide 

^he Style Guide option serves two roles, as follows: 

o To allow you to provide a consistent look and feel to HTML documents generated by a dynamic service, and to 
be able to change this at one source. 

o To provide an easy way of maintaining common variables to be used in dynamically generated HTML code. The 
use of a Style Guide provides an easy way for maintaining variables commonly used by all services in the whole 
system or just a range of services. If a variable needs to be changed, you only need to change it in the Style 
Guide and it will automatically have effect at run time in all services referencing the variable. 

The Inheritance Hierarchy list shows the hierarchy of categories and services within Cool ICE. At the top of the 
category is Cool ICE. You can specify a Style Guide for the whole system, for a category or for a service. A Style 
Guide specified at the system level will automatically apply to ail services in the system. A Style Guide specified for 
a selected category will only apply to a service within that category. A Style Guide specified for a single service will 
only apply to that service. 

Add 

Opens a dialog box for adding a keyword to the list. 
Modify 

Opens a dialog box for modifying the highlighted keyword in the list. 
Remove 

Deletes the highlighted keyword in the list. 
Re-Inherit 

Resets the Style Guide with the Style Guide defined for the level above it in the hierarchy. 
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$K+ Add-Modify Style Guide Keyword 

"The Add-Modify Style Guide Keyword option dialog is used to add or modify keywords in the list of Style Guide 
keywords. 

Keyword 

A unique entry of an item in the Style Guide. At run time the Cool ICE Service Handler will create a Mapper variable 
out of the keyword containing the value specified in the Value field. A service can then use the keyword where 
appropriate just be referencing the equivalent variable. 

Value 

The content of the item in the Style Guide. 
Description 

A short description of the entry. 

The Color Chart button displays a color chart . 
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$K+ Color Chart 

"The Color Chart is used for selecting one of the 16 basic colors for a Style Guide entry. The color value is returned 
as a red, green, blue (RGB) hexadecimal value. 
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$K+ Arrange Categories/Objects 

*The Arrange Categories and Objects option is used for manipulating the order in which you want Categories and 
Objects to be listed when displayed for the browser user and also when browsing the Cool ICE Repository using 
the Cool ICE Administration functions. 

Arrange Objects 

This will open a dialog box displaying a list of objects within the highlighted category allowing you to arrange 
objects within that category. 

Move 

This will identify and select the highlighted category as the one to be moved. The category to be moved will be 
shown in the field Category to move. 

Insert Before 

This will move and insert the category shown in the field Category to move before the category highlighted in the 
list of categories. 

Insert After 

This will move and insert the category shown in the field Category to move after the category highlighted in the list 
of categories. 
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$ Arrange Objects 

"The Arrange Objects option is accessed from the Arrange Cateaories/Obiects function and is used for 
manipulating the order in which you want Objects to be listed when displayed for the browser user and also when 
browsing the Cool ICE Repository using the Cool ICE Administration functions. 

Move 

This will identify and select the highlighted object as the one to be moved. The object to be moved will be shown in 
the field Object to move. 

Insert Before 

This will move and insert the object shown in the field Object to move before the object highlighted in the list of 
objects. 

Insert After 

This will move and insert the object shown in the field Object to move after the object highlighted in the list of 
objects. 
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File Transfer 



^he File Transfer option is provided primarily for transferring images between the service developers workstation 
and the Cool ICE web server. However, the file transfer will allow transfer of any file. 

Images being transferred to the web server using the file transfer option will be stored in directories outside the 
Cool ICE Repository. As described for Image Directory Aliases , storing images in directories outside the Cool ICE 
Repository mean images are not secured and managed by the Cool ICE system. This should only be used when 
performance of sending images to the browser is more important than managing the images by the Cool ICE 
Administration environment. 

Server 

In this frame you select server directory alias and/or files you want to transfer to/from depending on which transfer 
function you select (Transfer from Server or Transfer from Workstation). 

Server Alias Directory 

This is a list of Image Directory Aliases as setup using the Image Directory Aliases function . When selecting an 
alias, a list of files within the corresponding directory will be displayed. The selection of server directories is 
limited to directories setup using the Image Directory Aliases function. 

Select files or Select All 

When transferring files from server to workstation you will select the files to transfer either by highlighting 
individual files from the list or check the Select AN box for selecting all files within the list. When using the 
Select All option the files will not be highlighted. 

Workstation 

In this frame you select workstation directory and/or files you want to transfer to/from depending on which transfer 
function you select (Transfer from Server or Transfer from Workstation). 

Directories 

This is a list of directories on your workstation. When selecting a directory, a list of files within that directory will 
be displayed. 

Select files or Select All 

When transferring files from workstation to server you will select the files to transfer either by highlighting 
individual files from the list or check the Select All box for selecting all files within the list. When using the 
Select All option the files will not be highlighted. 

Transfer from Server 

Selecting this button will transfer files from the Cool ICE web server to the service developers workstation. Files to 
transfer must be selected within the Server frame. A dialog box will be opened to show a list of files selected and 
ask for a confirmation to start the transfer. 

Transfer from Workstation 

Selecting this button will transfer files from the service developers workstation to the Cool ICE web server. Files to 
transfer must be selected within the Workstation frame. A dialog box will be opened to show a list of files selected 
and ask for a confirmation to start the transfer. 
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File Transfer from Server to Workstation 



This dialog box allows you to confirm the file transfer. A list of files selected within the specified server alias 
directory is listed requesting you to confirm the transfer. 

Transfer Now 

Selecting this button will start the transfer from the Server to the Workstation. 
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$K+ File Transfer from Workstation to Server 

^his dialog box allows you to confirm the file transfer. A list of files selected within the specified workstation 
directory is listed requesting you to confirm the transfer. 

Transfer Now 

Selecting this button will start the transfer from the Workstation to the Server. 
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$K+ lmage Directory Aliases 

*The image Directory Aliases option allows you to maintain a table of mappings to directories on the Web Server 
allocated for storing image files. This is used when you are importing HTML template and documents and check 
the Uploading Images to the Web Server button. This table provides a list of valid image directories into which 
images can be uploaded. 

Storing images in these image directories mean that images are kept outside the Cool ICE Repository and as such 
they are not secured and managed by the Cool ICE system. This option is recommended to use only when 
performance of sending images to the browser is more important than managing the images by the Cool ICE 
Administration environment. 

Add 

Opens a dialog box for adding a new alias to the list. 
Modify 

Opens a dialog box for modifying the highlighted alias in the list. 
Remove 

Deletes the highlighted alias from the list. 
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Add-Modify Image Directory 



*The Add-Modify Image Directory option dialog is used to add or modify a server image directory. Cool ICE uses 
these directories for storing images on the server. 

Alias 

A unique short name for an image directory. The alias must be defined in the Web Server as a valid alias. On some 
Web Servers (for example, Netscape Web Server) this is also called a Prefix. The alias is specified in the URL and 
the Web Server translates it into the physical path. 

Server Image Directory 

The physical path name of the directory. 

Default Cool ICE System Image Directory 

This is checked for the directory that Cool ICE will use for storing images referenced specifically by Cool ICE. That 
is, images and icons used in Cool ICE menus and system error massages. Only one directory can be the default 
directory. 
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$K+ Browser SignOn Configuration 

^he Browser SignOn Configuration option allows you to configure how users coming into Cool ICE from a browser 
will identify themselves. When the Cool ICE Gateway has been configured to request user sign-on, the actual sign- 
on form will be requested from the Cool ICE System. This dialog allows you to configure the content of the sign-on 
form. 

Provided you keep the basic content as it exists in the system sign-on form, you can redesign the look and feel of 
the form using an HTML authoring tool and replacing the system sign-on form. 

Request Department Number 

Shows an input box in the form, requesting the user to type in the Mapper department number their user-id belongs 
to. 

Hide Department Number 

Hides the input box and as such it will not request the user to specify their Mapper department number. In this case 
all valid Cool ICE users must belong to the same Mapper department. This department number is specified in the 
department field of the Guest User-Id frame. 

User-Id - Department and Password 

When specified, will pre-fill the sign-on form to indicate a default user-id which can be used for casual users. 
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$K+ CooI ICE System Settings 

*The Cool ICE Systems Settings functions access to Cool ICE options at the system level. These are deployment 
options which have effect at runtime when a user is accessing the Cool ICE system from a browser. 

System Availability 

This allows to take the whole Cool ICE system off-line and on-line. If Cool ICE is taken off-line, the user accessing 
Cool ICE from the browser will receive a message indicating the system is not available. 

Service Handler Trace 

This allows to turn trace on/off for the Cool ICE service Handler. Service Handler trace information is kept in the F- 
drawer of the cabinet where Cool ICE is installed. Report 2F contains the input received from the Gateway. Report 
3F contains output received from the service being called. Report 4F contains the service input report created by 
the Service Handler. These three reports will be reused and overwritten for every service call. 

Category Icon 

This allows to setup the preferred default icon to be used when displaying a list of categories to the browser user. 
You click on the browse button to browse and select the icon from the Cool ICE Repository. The Reset button will 
reset to the icon before selecting this function. 

Object Icon 

This allows to setup the preferred default icon to be used when displaying a list of objects to the browser user. You 
click on the browse button to browse and select the icon from the Cool ICE Repository. The Reset button will reset 
to the icon before selecting this function. 
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$K+ Graphics Server Settings 

Configuring the Graphics Server is only required for Cool ICE systems running on UnixWare. 

The Graphics Server software on Cool ICE systems on UnixWare is running on a PC and a request to produce a 
graph is passed from Cool ICE to the Graphics Server via a TCP/IP connection. Cool ICE must know on which PC 
the Graphics Server software is installed and on which socket the Graphics Server will receive a request. 

Name or IP address of PC running Graphics Server 

This specifies either the name or the IP address of the PC where the Graphics Server software is running. 
Socket number configured in the Graphics Server 

This specifies the socket number configured in the Graphics Server. The default number is 1234. 
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^Miscellaneous 

^his following topics document miscellaneous dialog boxes used in Cool ICE Administration. 

• Server Directory Inquiry 

• Workstation Browser 

• Cool ICE Database Drawer Browser 

• Cool ICE Database Report Browser 

• Cool ICE Repository Browser 

• Cool ICE System Variables 
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Server Directory Inquiry 



# Cool ICE will attempt to verify the existence of directories on the Cool ICE server by passing a directory inquiry on 
to the Operating System. In order for the Operating System to allow such a request a userid and password is 
required which allow access to the OS. On NT systems, the userid being used for starting the Mapper NT software 
must have the user right "Log on as a batch job" in order to pass a DOS command to NT. 

On a system configured with the above mentioned user right, only users who are connecting in to the Cool ICE 
Administration environment via a remote connection such as MSW (Mapper System for Windows) will be required 
to specify a userid/password. The userid/password entered will be remembered by the system and as long as the 
userid stays valid you will not be asked to provide this again for any subsequent server directory inquiry. The userid 
is kept on a COOLICE.INI file on your workstation. When the userid becomes invalid, you will be asked to specify a 
new valid userid/password. 

Server Userid 

This is a Userid on the Operating system (NT UserlD or Unix UserlD). 

On NT systems this userid must have the user right to "Log on as a batch job" and be a member of the Mapper 
Group. 

Server Password 

This is a password associated with the userid. 
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$K+ Workstation Browser 

''This allows you to browse and select directories and files on your workstation or network drives your workstation 
have access to. 

You select a directory by double click on a directory in the list of directories. 
You select a file by double click on a file in the list of files. 

Preview 

The preview button will display the content of a file you previously have selected by double click on a file in the list 
of files. This can only display content of files with TXT, .HTM or .HTML extension. 
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$K+ Cool ICE Database Report Browser 

*This Cool ICE Database Report Browser is displayed when selecting to browse the Cool ICE database. It allows 
you to browse and select an existing report from the database. 

You select a Cool ICE Database Drawer by double click on a drawer in the list of drawers. 
You select a Cool ICE Database Report by double click on a report in the list of reports. 
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$K+ Cool ICE Repository Browser 

"This allows you to browse and select an object from the Cool ICE Repository. 

You select a Cool ICE Category by double click on a category in the list of categories. 

You select a Cool ICE Object by double click on an object in the list of objects. 
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SK+ Cool ICE System Variables 

* 
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$K+ Cool ICE Database Drawer Browser 

^he Drawer Browser is displayed when selecting browse. It allows you to browse and select an open (available) 
Cool ICE Database drawer and cabinet to store your Cool ICE category. 

An available drawer for storing your Cool ICE category is listed as being OPEN in the Drawer Browser. 
You select a drawer by double clicking on an open one in the list of drawers. 
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